home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / vote40.zip / VOTEDOOR.DOC < prev    next >
Text File  |  1991-02-17  |  6KB  |  155 lines
  1.  
  2.                   -=( LiveSystems voting door )=-
  3.  
  4.  
  5.      What is it?
  6.  
  7.      The voting door is a program which allows users to ask and
  8.      answer each others questions. A user can add questions to the
  9.      database and other users can vote on those questions.
  10.      I wrote the program as I didn't really like the usersurvey
  11.      program already available. It's colors are awful.. Besides,
  12.      I needed a dutch version so I wrote my own, with some extra
  13.      bells and whistles. So this is the english version of the dutch
  14.      version which is a clone of the already available program..;)
  15.  
  16.      This program has the almost the same features as the original,
  17.      with a few exceptions which reflect my view on the ability of
  18.      the SysOp to censor questions...
  19.  
  20.      Warning: This program only works under Remote Access! I needs
  21.      the Config.RA file.
  22.  
  23.  
  24.      Disclaimer.
  25.  
  26.      Don't make me laugh...;) Use it at your own risk. It's reasonal
  27.      well tested, I use it myself (the dutch version) but that's it!
  28.      Oh well, I wouldn't release a program that's not up to my idea
  29.      of good software. (At the moment I release it, that is.. things
  30.      change and bug appear from nowhere....;) Anyhow, no guarantees
  31.      what so ever.
  32.  
  33.      Money.
  34.  
  35.      Well, what to say about money.. I still waiting for the first one
  36.      to donate some money for the purse-aid.. Maybe you will be the
  37.      first and rebuild my confidence in humanity... Let's say $5
  38.      when you keep on using this program..
  39.  
  40.      Giro 1806776 (for the dutch ppl who like the english better. f10 is
  41.                    ok with me too..)
  42.  
  43.      Gerhard Hoogterp
  44.      Kremersmaten 108
  45.      7511 LC Enschede
  46.      Holland.
  47.  
  48.      For burning questions or remarks you can reach me on fidonet as
  49.  
  50.      Gerhard Hoogterp @ 2:283/1.2
  51.  
  52.      or on BitNet as HOOGTERPG@HENUT5
  53.      Installation:
  54.  
  55.      The installation of the program is quite easy. It gets most of the
  56.      necessary info from the config.ra and the exitinfo.bbs
  57.      (Which implies that you can only run it under RA, local or remote..)
  58.  
  59.      * First make sure the environment variable RA is pointing to the
  60.        directory RA stores it's configuration files.
  61.  
  62.      * Make a directory and dump all the votedoor files in it.
  63.  
  64.      * Make a type 7 menu entry in one of the RA menus
  65.        (See next chapter for details on parameters)
  66.  
  67.      * put VoteMain in your daily maintenance.
  68.  
  69.  
  70.      That's all to start with.
  71.  
  72.      The programs and the parameters.
  73.  
  74.      VoteDoor.Exe:
  75.  
  76.      This is the voting program itself. It accepts two parameters, but if
  77.      you want to use the second, you have to use the first too...
  78.  
  79.      The syntax is: VoteDoor -T:<Time left> -N:<node> [-P:<CommPort>]
  80.                              [-SEC:<Min Sec Level>] [-S:OFF]
  81.  
  82.      Time Left is the time the user has left for the current session.
  83.      Min Sec Lev is the minimal security level needed to add questions.
  84.      This way you can prevent unchecked new users to add questions, but
  85.      they can vote and see that your BBS offers them this wonderful
  86.      possibility ;) The -S:OFF turns the noise made when the use makes
  87.      a mistake off default and the -P:*P can be used in a multiline
  88.      environment to overrule the setting in the CONFIG.RA
  89.  
  90.      An example of a menuentry could be:
  91.  
  92.      Type          7
  93.      Key           V
  94.      Optional data c:\vote\votedoor -T:*T -N:*N -P:*P -SEC:15
  95.  
  96.      You may use the memory swapping parameter but it's not realy
  97.      nessecary. I did run votedoor in a 100kb DesqView partition with
  98.      no problems.
  99.  
  100.      VoteMain.exe
  101.  
  102.      This is the new maintain utility for VoteDoor. You cannot use it
  103.      on datafiles of version lower than 3.0!
  104.  
  105.      VoteMain can be run remote and has all the options of the previouse
  106.      PackVote and MainVote together in one program. Here's the syntax:
  107.  
  108.        VoteMain [DEL] <MaxDaysOld>
  109.  
  110.      When you specify the DEL parameter, VoteMain will ask you if you want
  111.      to delete records. This is for interactieve use!
  112.  
  113.      The MaxDaysOld parameter specifies after how many days a question
  114.      is deleted from the database and added to the history.txt file.
  115.  
  116.      MaxDaysOld ISN'T optional!! if you omit a value, 0 days old is
  117.      used, and the whole questionbase is moved to the history file!
  118.  
  119.      In your daily or weekly event batch file you should only use:
  120.  
  121.        VoteMain <MaxDaysOld>
  122.  
  123.      You can install VoteMain in the RA BBS with a normal MenuItem 7
  124.      and the parameters you want.
  125.  
  126.      Last remarks:
  127.  
  128.      Default all the three executables use the directory they are fired
  129.      up from as the default directory to store the data and text files.
  130.      If you want them somewhere else (Multitasker f.e.) you can set the
  131.      environment variable VOTEDOOR to point to the desired directory.
  132.  
  133.      The vote door uses 3 data files:
  134.  
  135.      Quest.dat   questions and answers. the real database
  136.      Voted.dat   the lists of ppl who already voted. One record for
  137.                  every question
  138.      History.txt textfile with the results of the old and removed
  139.                  question.
  140.  
  141.  
  142.  
  143.      Within the votedoor a helpfile is available. See this file for
  144.      the details on how to use the vote door.
  145.  
  146.      The door uses the user timeout value of RA. If the user is idle
  147.      for this time he gets 3 warnings. After that he's dropped back to
  148.      the BBS.
  149.  
  150.      For those who want to have an intro screen and a goodbye screen
  151.      vote door looks for a PreVote.Asc/ans and a PostVote.Ans/Asc
  152.      When the file is found in the votedoor directory it is showed.
  153.      If there's no ANS file it looks for the asc file. If there's
  154.      no file it's skipped.
  155.